home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / win_m_p / pwez51.zip / READ.ME < prev    next >
Text File  |  1992-04-01  |  18KB  |  437 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                       **  MISCELLANEOUS INFORMATION **
  9.  
  10.  
  11.      1.  The manual provided in the ENHANCED version of WINDOW R-E-Z
  12.          is in a self-extracting, compressed format.
  13.  
  14.          The manual requires 245,000 free bytes available on the
  15.          drive in which it will reside.  THERE IS NOT ENOUGH ROOM
  16.          ON THE DISK PROVIDED.  It will be necessary, therefore, to
  17.          copy the file WIND_REZ.EXE to a disk with sufficient available
  18.          space prior to un-compressing the manual.  After the manual
  19.          is un-compressed the file, WIND_REZ.EXE may be deleted.
  20.  
  21.          To un-compress the manual at the DOS prompt enter:
  22.  
  23.                              WIND_REZ.EXE
  24.  
  25.          The file, WIND_REZ.EXE, must be in the default drive and
  26.          current directory.
  27.  
  28.          The manual in the UNENHANCED version is un-compressed
  29.          with the other files contained in the upload.
  30.  
  31.  
  32.      2.  To print the manual at the DOS prompt enter:
  33.  
  34.          PRNTDOT       ( For most printers )
  35.          PRNTLAS       ( For HP compatible laser printers )
  36.  
  37.          PRNTDOT.BAT or PRNTLAS.BAT and WIND_REZ.DOC must be in the
  38.          default drive and current directory.
  39.  
  40.  
  41.      3.  To print the quick reference guide ( enhanced version
  42.          only ) at the DOS prompt enter;
  43.  
  44.          PRNTDOT2     ( For most printers )
  45.          PRNTLAS2     ( For HP compatible laser printer )
  46.  
  47.          PRNTDOT2.BAT or PRNTLAS2.BAT and QUICKREF.DOC must be in
  48.          the default drive and current directory.
  49.  
  50.  
  51.      4.  To run the demonstration program at the DOS prompt, enter:
  52.  
  53.                                 DEMO
  54.  
  55.  
  56.      5.  NOTES FOR BASIC 7.+ USERS. ( ENHANCED VERSION )
  57.  
  58.          Do not use unnamed COMMON blocks in your program.  If your
  59.          program requires unnamed COMMON blocks see the section
  60.          "Important notes for BASIC 7.0/7.1 users." in the
  61.          documentation.
  62.  
  63.          There are two sets of libraries for BASIC 7.+.  Depending
  64.          on which version of BASIC you have, you will receive the
  65.          following.
  66.  
  67.          - PDSALL71.LIB, PDSALL71.QLB, PDSNER71.LIB and PDSNER71.QLB
  68.            are for BASIC 7.1
  69.  
  70.          - PDSALL70.LIB, PDSALL70.QLB, PDSNER70.LIB and PDSNER70.QLB
  71.            are for BASIC 7.0
  72.  
  73.          The libraries were produced from within the QBX environment.
  74.          QBX compiles using the far string option.  You must use the
  75.          far string ( /Fs ) option if you compile outside the QBX
  76.          environment.
  77.  
  78.          If you are using BASIC 7.0 and upgrade to BASIC 7.1 you
  79.          can create your own compatible library by loading QBX with
  80.          PDSASM.QLB ( QBX/L PDSASM ).  Load all of the basic files
  81.          required by WINDOWS R-E-Z.
  82.  
  83.                         DIRWIND.BAS
  84.                         INPTWIND.BAS
  85.                         PULLDOWN.BAS
  86.                         SCROLL.BAS
  87.                         WIND_REZ.BAS
  88.                         PDSMEM.BAS
  89.  
  90.          Make the library from within the QBX environment. The
  91.          library will contain all routines and have error detection.
  92.  
  93.      6. NOTE FOR BASIC 7.+ USERS.  ( UNENHANCED VERSION )
  94.  
  95.          Do not use unnamed COMMON blocks in your program.  The
  96.          enhanced version of WINDOWS R-E-Z provides the ability to
  97.          use unnamed COMMON blocks.
  98.  
  99.          The library, PDSUNEN.LIB, contains object files made
  100.          from the BASIC 7.1 compiler.  While making an executable
  101.          file from within QBX, the following message will appear
  102.          FOR BASIC 7.0 USERS ONLY.
  103.  
  104.          LINK WARNING L4051: BRT71EFR.LIB: CANNOT FIND LIBRARY
  105.          Enter new file spec:
  106.  
  107.          Press ENTER or RETURN.  The file, BRT71EFR.LIB is not
  108.          required.
  109.  
  110.      7. NOTE FOR USERS OF UNENHANCED VERSION FOR QUICKBASIC AND
  111.         BASIC 7.+.
  112.  
  113.         Only four Multi-field input screens are permitted with a
  114.         maximum of 25 fields per screen in the unenhanced versions
  115.         of WINDOWS R-E-Z.
  116.  
  117.         Keyboard problems ( BACKSPACE, "G" ) may surface for users
  118.         of QuickBASIC 4.00/4.00b.  See page 3 of the documentation,
  119.         WIND_REZ.DOC, for a fix if required.
  120.  
  121.  
  122.      8.            ** NEW FEATURES IN VERSION 5.10/5.00  **
  123.                ( See WIND_REZ.DOC and UPDATE.DOC for details. )
  124.  
  125.          New - Version 5.10
  126.  
  127.           - User definable exit keys for scroll windows and pulldown
  128.             windows.
  129.  
  130.           - A new routine, B4SCRL.  In addition to setting the exit keys
  131.             for a subsequent single call to SCRLWIND, this routine
  132.             allows entries in a "mark" scroll window to be marked
  133.             (tagged) on entry.
  134.  
  135.           - "Extendable" scroll windows allow users to scroll through
  136.             random access, ISAM, BTRIEVE or other large data files.
  137.  
  138.           - A new routine, SETSCRL.  This routine assumes some of the
  139.             responsiblities previously handled by routine SETWIND.  In
  140.             addition it can be used to  set the color of the arrow
  141.             designating marked (tagged) entries in a "mark" scroll
  142.             window.
  143.  
  144.           - Additional arguments in routine SCRLWIND allow entry with
  145.             the scroll bar over a specified entry on a specified line in
  146.             the scroll window.  Virtual scroll windows may be entered
  147.             with any permissible character position occupying the first
  148.             column of the scroll window.
  149.  
  150.           - Changes in routine GETANS permit the key selected to be
  151.             displayed to the right of the prompt.  When used in this
  152.             manner the user must press ENTER to exit GETANS.  GETANS
  153.             may also be used as in previous versions.
  154.  
  155.  
  156.          New - Version 5.00
  157.  
  158.           - Info-line routines display messages, directions or prompts
  159.             at any screen location.  These routines may be used in
  160.             conjunction with pulldown or scroll windows or as stand
  161.             alone routines.
  162.  
  163.               o  Routine INFOLINE sets coordinates for, and saves the
  164.                  display area to be used by the info-line.
  165.  
  166.               o  Routine PRINTINFO prints the info-line.
  167.  
  168.               o  Routine INFOFIXED sets a fixed info-string which
  169.                  precedes text printed on the info-line by routine
  170.                  PRINTINFO.
  171.  
  172.           -  Simplified set-up for pulldown windows.  The pulldown
  173.              menubar, info-line data for the menubar selections, and
  174.              window selections are all placed in a single array.
  175.  
  176.           -  Variable spacing for pulldown menubar selections.
  177.  
  178.           -  A new routine, RSTRPULL allows the flexibility to keep
  179.              the active pulldown window, on exit from routine PULLDOWN,
  180.              displayed.
  181.  
  182.           _  A new routine, INPTINIT, allows user selectable exit keys
  183.              for routine INPTWIND.  This simulates key trapping within
  184.              routine INPTWIND.
  185.  
  186.           _  A new routine, RSTRINPT, restores the active input window.
  187.              This replaces automatic restoration and allows data
  188.              verification before deleting the active input window. It
  189.              also allows re-entry into the active input window with-
  190.              out re-printing same.
  191.  
  192.           _  Simplification of routine MULTINPT.  Logical exit key
  193.              representation  for all exit possibilities is returned
  194.              to the programmer via one parameter.
  195.  
  196.           -  Increase from 100 to 150 fields per multi-field input
  197.              screens in the enhanced version.
  198.  
  199.           -  Virtual scroll windows allow horizontal and vertical
  200.              scrolling.
  201.  
  202.           -  List only scroll windows ( no scroll bar ) provide a
  203.              means to view regular or virtual scroll windows.
  204.  
  205.           -  A new function WAVAIL, reports a windows availability.
  206.  
  207.  
  208.      9.   Compatibility issues:
  209.  
  210.           NOTE: To assure compatibility with earlier versions replace
  211.           the declare statements in programs written with earlier
  212.           versions with the DECLARE.INC file included with version
  213.           5.10.  This will assure argument matching.  Failure to do
  214.           this can result in the program crashing.
  215.  
  216.           The following routines were changed or added in version
  217.           5.10 and are not compatible with earlier versions. Program
  218.           revisions are necessary for programs incorporating earlier
  219.           versions.  ( SEE WIND_REZ.DOC AND UPDATE.DOC FOR DETAILS )
  220.  
  221.           - SETWIND has two less arguments.  Routine SETSCRL now sets
  222.             scroll and pulldown window parameters.
  223.  
  224.           - Routine SCRLWIND has new arguments specifying the line and
  225.             column placement of the entries.
  226.  
  227.           - Routine PULLDOWN has two new arguments. One sets the
  228.             allowable "exit keys". This replaces the argument added in
  229.             version 5.00 which suppressed exit on ESC.  The other
  230.             returns a value representing the key used to exit.
  231.  
  232.           - Routine GETANS has two modes of operation. To use as in
  233.             previous versions argument ANS$ MUST equal "" on entry.
  234.  
  235.  
  236.           The following routines were changed or added in version
  237.           5.00 and are not compatible with earlier versions. Program
  238.           revisions are necessary for programs incorporating earlier
  239.           versions.  ( SEE WIND_REZ.DOC AND UPDATE.DOC FOR DETAILS )
  240.  
  241.           - SETWIND has less arguments.  Routine INPTINIT now sets input
  242.             parameters.
  243.  
  244.           - Routine INPTINIT must be called once in any program
  245.             prior to calling input routines INPTWIND and MULTINPT.
  246.  
  247.           - Two arguments in routine MULTINPT have different
  248.             responsibilities.
  249.  
  250.             o The values for the exit keys in argument RKEY% have
  251.               been expanded.  All exit possibilities are resolved
  252.               via argument RKEY%.
  253.  
  254.             o Checking for exit strings AUTO, FIXED, PGUP, PGDN,
  255.               ESC, and F1 to F10 is no longer required or possible
  256.               via old argument EXIT$.  EXIT$ is changed to CODE$
  257.               in version 5.00.  It determines the type of multi-
  258.               field input screen on input.
  259.  
  260.              Ver. 5.00 (argument RKEY%)    Previous versions (EXIT$)
  261.  
  262.               1 to 10                           "F1" to F10"
  263.               11                                "PGUP"
  264.               12                                "PGDN"
  265.               27                                "ESC"
  266.               32                                "FIXED"
  267.               Use value returned by argument    "AUTO"
  268.               AUTOEXIT% to check for auto-exit
  269.               fields. If field #1 was defined
  270.               as auto-exit and AUTOEXIT% = 1, on
  271.               exit, MULTINPT was exited with
  272.               the cursor residing in, or leaving
  273.               auto-exit field #1. If AUTOEXIT% = 0,
  274.               on exit, the field was not an auto-
  275.               exit field or was auto-exit, on
  276.               change, and the data was unchanged.
  277.  
  278.           - Argument RK% in routine INPTWIND returns different values
  279.             conforming to the exit key representation in routines
  280.             SCRLWIND and MULTINPT
  281.  
  282.             RK%                         EXIT KEY
  283.  
  284.             1 to 10                     F1 to F10
  285.             11                          PGUP
  286.             12                          PGDN
  287.             13                          RETURN (ENTER)
  288.             27                          ESC
  289.  
  290.           - Routine RSTRINPT must be called after a call to routine
  291.             INPTWIND if the area under the active input window is to be
  292.             restored and the active input window is to be deactivated.
  293.  
  294.           - The menubar definition for pulldown windows no longer
  295.             requires a separate argument in routine SETPULL.
  296.  
  297.           - The array defining pulldown windows in routine SETPULL
  298.             has been changed to include the menubar selections,
  299.             info-line text for the menubar selections, and the
  300.             individual pulldown window selections.
  301.  
  302.           - Routine PULLDOWN has two new arguments. One allows the
  303.             choice for exit on the ESC key.  The other represents
  304.             the text for the info-line for pulldown window selections.
  305.  
  306.           - Routine RSTRPULL must be called after routine PULLDOWN
  307.             if the display area under the active pulldown window,
  308.             on exit from routine PULLDOWN, is to be restored and
  309.             the active pulldown window is to be deactivated.
  310.  
  311.           _ Routine SCRLWIND has three additional arguments.
  312.  
  313.             o Argument INFO$() is an array holding the data for the
  314.               info-line for the selections in the scroll window.
  315.  
  316.             o Argument TL$ hold the title for scroll windows with a
  317.               title box.  Using TL$ allows a title longer than the
  318.               windows width for virtual scroll windows.
  319.  
  320.             o Argument RK% represents the key used to exit the scroll
  321.               window.
  322.  
  323.               RK%                       EXIT KEY
  324.  
  325.               13                        RETURN or auto-exit match
  326.               14                        SHIFT TAB ( Single mark only )
  327.               15                        TAB       "                  "
  328.               27                        ESC
  329.  
  330.           - The current directory returned by routine FINDPATH no
  331.             longer always ends with a "/".  DOS specifications
  332.             are now followed.
  333.  
  334.           - The argument in routine FINDDIR which specifies the path
  335.             no longer must end with a "/".  The argument now follows
  336.             DOS specifications.
  337.  
  338.  
  339.           The following routines were changed in version 4.20 and
  340.           are not compatible with earlier versions.  Minor program
  341.           revisions are necessary for programs incorporating
  342.           earlier versions.  ( SEE WIND_REZ.DOC FOR DETAILS )
  343.  
  344.           - SETWIND has an additional argument which specifies the
  345.             date format for input routines.
  346.  
  347.           - SETPULL has three additional arguments.  These arguments
  348.             set the menubar's top row and left column position and the
  349.             menubar's width.
  350.  
  351.           - INPTWIND has an additional argument.  It is used to deter-
  352.             mine if the RETURN key or ESC key exited the routine.
  353.  
  354.           - MULTINPT has an additional argument.  It is used to deter-
  355.             mine which key exited an autoexit field.
  356.  
  357.           The following routine was changed in version 4.10 and
  358.           is not compatible with earlier versions.  Minor program
  359.           revisions are necessary for programs incorporating
  360.           earlier versions.  ( SEE WIND_REZ.DOC FOR DETAILS )
  361.  
  362.           - SETWIND has an extra argument to disable the scroll window
  363.             direction arrow.
  364.  
  365.           - After a window is made or saved it must be deleted via
  366.             RSTRWIND or DELWIND before the number assigned to the window
  367.             can be used by again MAKEWIND or SAVEWIND.  This prevents a
  368.             window from being accidently "made over itself".  Failure
  369.             to delete a window before using the window number again
  370.             will result in an ERROR 8 - WINDOW PRE-EXISTS.
  371.  
  372.  
  373.           The following routines were changed in version 4.00/.01 and
  374.           are not compatible with earlier versions.  Minor program
  375.           revisions are necessary for programs incorporating
  376.           earlier versions.  ( SEE WIND_REZ.DOC FOR DETAILS )
  377.  
  378.           - GETANS, PULLDOWN, and INPTWIND have an extra argument
  379.             for border designation.
  380.  
  381.           - SETWIND now has five argument designating windowing
  382.             speed, default sound, window shadow color, high intensity
  383.             display for PULLDOWN and SCRLWIND, and the type of decimal
  384.             point ( period or comma for some non-USA users ).
  385.  
  386.           - SCRLWIND no longer has a argument for the window number
  387.             as it acts upon the active window.
  388.  
  389.           - SETINPT has an extra argument specifying the color of the
  390.             active field for MULTINPT.
  391.  
  392.           - FINDDIR has one less argument as it no longer has to
  393.             place the directory listing in a string.
  394.  
  395.           - SETSOUND is no longer required due to changes in SETWIND.
  396.  
  397.           - CHNGFAST is no longer required due to changes in SETWIND.
  398.  
  399.           - FILLDIR is no longer required due to changes in FINDDIR.
  400.  
  401.           - The argument designating the code ( CODE$ ) for INPTWIND
  402.             has changed.
  403.  
  404.           - The argument designating the type of directory search
  405.             ( TYPE$ ) in FINDDIR has changed.
  406.  
  407.  
  408.           The following routines were changed in version 3.60 and
  409.           are not compatible with earlier versions.  Minor program
  410.           revisions are necessary for programs incorporating
  411.           earlier versions.  ( SEE WIND_REZ.DOC FOR DETAILS )
  412.  
  413.           - PULLDOWN has an extra argument which sets the color of
  414.             the key character for the items in the pulldown window.
  415.             PULLDOWN no longer returns the selected menubar string
  416.             and pulldown window string to the calling program. It
  417.             returns the sequential number of the selected menubar
  418.             item and selected pulldown window item.
  419.  
  420.           - SCRLWIND has an extra argument which sets the color of
  421.             the key characters for the items in the scroll window.
  422.             SCRLWIND no longer returns the selected string.  It re-
  423.             turns the sequential number of the string in the scroll
  424.             window.
  425.  
  426.  
  427.           The following input routines changed in version 3.40,
  428.           are not compatible with earlier versions.  Minor program
  429.           revisions are necessary for programs incorporating
  430.           earlier versions.  ( SEE WIND_REZ.DOC FOR DETAILS )
  431.  
  432.           - INPTWIND and SETINPT have an extra argument defining
  433.             allowable characters for RESTRICTED fields.
  434.  
  435.           - MULTINPT has an additional argument which determines
  436.             if all fields or single fields are updated.
  437.